Skip to content

refactor(supervisor): add backend-neutral boundary primitives - #2942

Draft
drew wants to merge 1 commit into
codex/1737-rfc12-contractfrom
codex/1737-rfc12-supervisor-primitives
Draft

refactor(supervisor): add backend-neutral boundary primitives#2942
drew wants to merge 1 commit into
codex/1737-rfc12-contractfrom
codex/1737-rfc12-supervisor-primitives

Conversation

@drew

@drew drew commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Add permanent backend-neutral boundary primitives to the process and network supervisor leaves while preserving the legacy orchestration path. This is PR 2 of 2 in the draft stack. PR #2943 is an unstacked follow-on that prototypes runtime activation.

Stack: codex/1737-rfc12-contractthis PR. Unstacked follow-on: #2943.

Review-only prototype: The original code author is @jganoff, and the original implementation source is jganoff/OpenShell:jganoff/rfc-0012-impl. This reconstructed stack is for reviewing and prototyping RFC 0012; we do not intend to merge these PRs. The stack is rebased onto current main and integrated with the current canonical process and networking architecture.

Related Issue

Part of #1737. The final PR in this stack closes the issue.

Changes

  • Add boundary-owned process, exec, PTY, signal, wait, and cleanup primitives around the canonical main-process session.
  • Allow network mediation to consume an optional backend-provided source without removing transparent TCP or legacy listeners.
  • Resolve binary identity before mediation and fail closed on unresolved ownership.
  • Add strict network-namespace egress-ceiling installation and verification APIs.
  • Retain legacy networking with an explicit None mediation source.

Testing

  • Supervisor process, network, and sandbox crates compile together
  • Contract tests pass
  • Privileged/socket tests require an environment that permits namespace and socket creation

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (covered by PRs 1 and 3)

@copy-pr-bot

copy-pr-bot Bot commented Aug 26, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

Signed-off-by: Drew Newberry <385+drew@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant